home *** CD-ROM | disk | FTP | other *** search
/ MacAddict: Utilities / MacAddict S Utilities.iso / Utilities / Connectivity / WhurlPlug ƒ / Whurlplug Read Me v1.0d6 < prev   
Text File  |  1996-03-15  |  7KB  |  123 lines
  1.  
  2. Whurlplug, created by John Louch, is a Power Macintosh native Netscape™ plugin for viewing 3DMF models. Whurlplug is currently under devlopment and is considered demoware.  Whurlplug relies on QuickDraw 3D, Apple's 3D graphics API, for rendering, picking, and navigation.   Whurlplug allows you to view and act upon 3D models that are present on the web.  At this time it has simple keyboard navigation, with mouse control coming in a later version
  3.  
  4. Note: Whurlplug requires QuickDraw 3D. If you don't have QuickDraw 3D, you can obtain it  through the QuickDraw 3D web site (http://www.info.apple.com/qd3d).   The latest version is 1.0.4.
  5.  
  6. Please send any requests or bug reports John Louch (jlouch@apple.com)
  7.  
  8.    Version History
  9.  
  10. 1.0d1    -    Initial release to the public
  11. 1.0d2 - Fixed memory leak bugs, if you were running with a debug version
  12.         of Quickdraw 3D you would have these bugs as Macsbug errors.
  13.                   - Added ROTATE attribute for the <EMBED …> HTML command.
  14.                      - Fixed problems with the popup menu in non-active mode.
  15. 1.0d3    - Fixed memory allocation bugs
  16.                      - Added TOOLBAR attribute for the <EMBED …> HTML command.
  17.                         - Added command clicking to bring up the popup menu
  18. 1.0d4 - Fixed clipping problems
  19. 1.0d5 - Allow ROTATE attribute to take float and negative numbers
  20.       - During keyboard navigation the object is now centered in the view
  21. 1.0d6 - Fixed problem where Whurlplug would crash if your monitor was set to
  22.                           to 256 colors or lower.
  23.  
  24.     Known Bugs
  25. • There are some problems with the code that cause the frame to draw around the plugin.
  26.   
  27.     Quick How to Use
  28.  
  29. To install:
  30. Drag the Whurlplug icon into the "Plug-ins" folder of Netscape 2.0.
  31.  
  32. To manipulate a 3D model:
  33. Use the buttons in the toolbar.  From left to right these tools are:
  34.  
  35. Camera     - Click and hold on this button, a popup menu will appear allowing you to reset the         camera.
  36.  
  37. Distance - Click and drag upward to move the object away from you. Drag down to move the item towards you.
  38.  
  39. Rotation - Click on the object or outside of the object and move the mouse. Notice that the positioning of where you click determines the axis and type fo rotation.
  40.  
  41. Panning - Click and drag right or left of up or down to pan the object around on the screen
  42.  
  43.  
  44. To navigate a 3D model:
  45. Currently navigation is controlled through the keyboard, make sure the plugin is focused by clicking in it, before you navigate.  Use the arrow keys on your keyboard to navigate.
  46.  
  47. Traverse
  48.   - Up arrow: will move you into the model
  49.   - Down arrow: will move you away from the model
  50.   - Left arrow : will move you to the left of the model
  51.   - Right arrow: will move you to the right of the model
  52.   - Control + Up arrow: will move you up
  53.   - Control + Down arrow: will move you down
  54.  
  55. Rotate
  56.   - Shift + Up arrow: will cause you to rotate around yourself by looking up
  57.   - Shift + Down arrow: will cause you to rotate around yourself by looking down
  58.   - Shift + Left arrow: will cause you to rotate around yourself by looking left
  59.   - Shift + Right arrow: will cause you to rotate around yourself by looking right
  60.  
  61. Rotate Environment
  62.   - Option Shift + Up arrow: will rotate around the center the model by moving up
  63.   - Option Shift + Down arrow: will rotate around the center the model by moving down
  64.   - Option Shift + Left arrow: will rotate around the center of the model by moving left
  65.   - Option Shift + Right arrow: will rotate around the center of the model by moving right
  66.  
  67. Look
  68.   - Option + Up arrow: will cause you to look up
  69.   - Option + Down arrow: will cause you to look down
  70.   - Option + Left arrow: will cause you to look left
  71.   - Option + Right arrow: will cause you to look right
  72.  
  73. Resize
  74.   - '-' key: will make you smaller relative to the model
  75.   - "=" key: will make you larger relative to the model
  76.  
  77. To Handle URL links:
  78.  
  79. Whurlplug understands URLs that are attached to 3D objects in a model.  I you move your mouse over one of these models then the 3D object will blink and the Netscape™ status bar will tell you the url you are over.  If you click on that object you will be taken to the URL.  If you need to create model that have url links you can use BeWhurled (located at Apple Computers, Inc. home page http://www.info.apple.com/qd3d) or other modeling packages such as Microspot's 3D world. Note: holding the control key down when over a URL will allow you to navigatge with your mouse without taking you to the URL.
  80.  
  81. Settings Popup Menu:
  82.  
  83. I you hold the mouse down on the toolbar at the bottom of the plugin, you will get a popup allowing you to set the background color, save the 3D object to disk and other options.  If the plugin is not active (see discussion below) then pressing anywhere and holding will cause the popup to appear.  Note: To force the popup to appear anywhere hold the command key down while clicking.
  84.  
  85.  
  86.     How to Create Web Content
  87.  
  88. Whurlplug can be embeded or take over the full screen depending on how you set up your html page.
  89. The mime type for 3DMF (Apple Computer, Inc.'s 3D metafile format) is x-world/x-3dmf.  The extensions that Whurlplug understands are .3dmf, .3dm, .qd3d, .qd3.
  90.  
  91. There currently a bug in Netscape which causes files of creator 'ttxt' (TeachText) to not be understood correctly.
  92.  
  93. Non-Embeded Example:
  94.  
  95. <A HREF="3dObject.3dmf>
  96.  
  97. Embeded Examples:
  98.  
  99. <EMBED SRC="3dObject.3dmf" WIDTH=200 HEIGHT=200> 
  100.  
  101. With extended parameters:
  102. <EMBED SRC="3dObject.3dmf" WIDTH=200 HEIGHT=200 SPIN=true ACTIVE=false 
  103. BGCOLOR="0xfffff" TOOLBAR=false>
  104.  
  105. With Rotate parameter:
  106. <EMBED SRC="3dObject.3dmf" WIDTH=200 HEIGHT=200 ROTATE="5 10 3">
  107.  
  108. The embeded argument is exactly the same as the html one, except with the addition of three parameters defined by Whurlplug:
  109.  
  110. SPIN - if spin is true the object will be spining when it first opens
  111. ACTIVE - if active is false then the 3D object will never be able to be edited.
  112. BGCOLOR - will set the background color of the plugin. The format is of the form
  113.                                     bgcolor="#ffffff".  A Hex stream from red to green.
  114. ROTATE - causes the object to spin on the x y and z axis passed in.  The form is
  115.                 ROTATE="x y z", were x y and z must be between -180 and 180.  This argument
  116.                               will overide the SPIN argument if it is present.
  117. TOOLBAR - if false causes the toolbar not to be shown as well as the bounding rectangle.
  118. RENDER - if render equals "interactive" then the plugin uses the interactive renderer.
  119.                if render equals "wireframe" then the plugin uses the wireframe renderer.
  120.  
  121. You do not have to put any of the extra parameters in the EMBED command to get the plugin to work.
  122.  
  123.